home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / dev / gcc / gcc260utilsdoc.lha / gnu / man / man1 / mt.1 < prev    next >
Encoding:
Text File  |  1994-07-31  |  3.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. MT(1L)            MISC. REFERENCE MANUAL PAGES             MT(1L)
  5.  
  6.  
  7.  
  8. NAME
  9.      mt - control magnetic tape drive operation
  10.  
  11. SYNOPSIS
  12.      mt [-V] [-f device]  [--file=device]  [--version]  operation
  13.      [count]
  14.  
  15. DESCRIPTION
  16.      This manual page documents the GNU version of mt.   mt  per-
  17.      forms  the  given  _o_p_e_r_a_t_i_o_n,  which must be one of the tape
  18.      operations listed below, on a tape drive.
  19.  
  20.      The default tape device to operate on is taken from the file
  21.      /_g_n_u/_i_n_c_l_u_d_e/_s_y_s/_m_t_i_o._h  when  mt  is  compiled.   It can be
  22.      overridden by giving a device file name in  the  environment
  23.      variable TAPE or by a command line option (see below), which
  24.      also overrides the environment variable.
  25.  
  26.      The device must be either a  character  special  file  or  a
  27.      remote  tape  drive.  To use a tape drive on another machine
  28.      as the archive, use a filename that starts with `HOSTNAME:'.
  29.      The  hostname  can  be  preceded by a username and an `@' to
  30.      access the remote tape drive as that user, if you have  per-
  31.      mission  to  do  so  (typically  an  entry  in  that  user's
  32.      `~/.rhosts' file).
  33.  
  34.      The available operations are listed below.  Unique abbrevia-
  35.      tions are accepted.  Not all operations are available on all
  36.      systems, or work on all types of tape drives.   Some  opera-
  37.      tions  optionally  take  a  repeat count, which can be given
  38.      after the operation name and defaults to 1.
  39.  
  40.      eof, weof
  41.           Write _c_o_u_n_t EOF marks at current position.
  42.  
  43.      fsf  Forward space _c_o_u_n_t files.  The tape is  positioned  on
  44.           the first block of the next file.
  45.  
  46.      bsf  Backward space _c_o_u_n_t files.  The tape is positioned  on
  47.           the first block of the next file.
  48.  
  49.      fsr  Forward space _c_o_u_n_t records.
  50.  
  51.      bsr  Backward space _c_o_u_n_t records.
  52.  
  53.      bsfm Backward space _c_o_u_n_t file marks.   The  tape  is  posi-
  54.           tioned  on  the  beginning-of-the-tape side of the file
  55.           mark.
  56.  
  57.      asf  Absolute space to file  number  _c_o_u_n_t.   Equivalent  to
  58.           rewind followed by fsf _c_o_u_n_t.
  59.  
  60.  
  61.  
  62.  
  63. Sun Release 4.1           Last change:                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. MT(1L)            MISC. REFERENCE MANUAL PAGES             MT(1L)
  71.  
  72.  
  73.  
  74.      eom  Space to the end of the recorded media on the tape (for
  75.           appending files onto tapes).
  76.  
  77.      rewind
  78.           Rewind the tape.
  79.  
  80.      offline, rewoffl
  81.           Rewind the tape and, if applicable, unload the tape.
  82.  
  83.      status
  84.           Print status information about the tape unit.
  85.  
  86.      retension
  87.           Rewind the tape, then wind it to the end of  the  reel,
  88.           then rewind it again.
  89.  
  90.      erase
  91.           Erase the tape.
  92.  
  93.      mt exits with a status of 0 if the operation succeeded, 1 if
  94.      the  operation or device name given was invalid, or 2 if the
  95.      operation failed.
  96.  
  97.   OPTIONS
  98.      -_f, --_f_i_l_e=_d_e_v_i_c_e
  99.           Use _d_e_v_i_c_e as the  file  name  of  the  tape  drive  to
  100.           operate  on.   To  use a tape drive on another machine,
  101.           use a filename that starts with `HOSTNAME:'.  The host-
  102.           name can be preceded by a username and an `@' to access
  103.           the remote tape drive as that user, if you have permis-
  104.           sion  to  do  so  (typically  an  entry  in that user's
  105.           `~/.rhosts' file).
  106.  
  107.      -_V, --_v_e_r_s_i_o_n
  108.           Print the version number of mt.
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Sun Release 4.1           Last change:                          2
  130.  
  131.  
  132.  
  133.